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April 22,1986 V00:10 

May 9, 1986 V00:20 

August 7, 1986 V00:30 


initial Release 

lnt2Dec, Long2Dec, Dec2lnt and 
Dec2Long calls modified 

Errors in the input/output lists for 
the math routines fixed 

Functions $10 to $21 expanded. 


STANDARD TOOL SET CALLS 


IMBootlnit Function number * $01 

This call does nothing. 

IMStartUp Function number = $02 

This call does nothing. 

IMShutDown Function number - $03 

\ 

This call does nothing. 

IMVersion Function number = $04 

Input Word Space for Result 

Output Word Result 

This call returns the version number for the Integer Math tool set. 

IMReset Function number * $05 

IMReset is called when a system reset occurs. It does nothing. 

IMActive Function number = $06 

Input Word Space for Result 

Output Word Result 

This call returns a non-zero result indicating that the tool set is active. 
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MATH ROUTINES 


These routines come from the Macintosh and are used throughout the tool box. 
Several types of numbers are supported - 

integer The common single word signed integer 

Long Integer The common double word signed integer 
Fixed A two word signed value with 16 bits of fraction 

Frac A two word signed value with 30 bits of fraction 


Multiply 


Function number = $09 


Input 

Input 

Input 

Output 


LongWord Space for Result 

Word Ml 

Word M2 

LongWord Result 


Takes the two 16 bit inputs, multiplies them together and produces a 32 
bit result. If the inputs were unsigned, the 32 bit result is unsigned. If the 
inputs were signed, the low word of the 32 bit result is the signed result. 


SDivide 


Function number = $0A 


Input 

Word 

Input 

Word 

Input 

Word 

Input 

Word 

Output 

Word 

Output 

Word 


Space for Remainder 

Space for Quotient 

Numerator 

Denominator 

Remainder 

Quotient 


Takes the two 16 bit signed inputs and divides them producing two 16 bit 
signed results. 
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UDivide 


Function number ■ $0B 


Input 

Word 

Input 

Word 

Input 

Word 

Input 

Word 

Output 

Word 

Output 

Word 


Space for Remainder 

Space for Quotient 

Numerator 

Denominator 

Remainder 

Quotient 


Takes the two 16 bit unsigned inputs and divides them producing two 16 
bit unsigned results. 


LongMul 


lul 

Function number« 

$0C 

Input 

. LongWord 

Space for Result 

Input 

LongWord 

Space for Result 

Input 

LongWord 

Ml 

Input 

LongWord 

M2 

Output 

LongWord 

Result (most significant) 

Output 

LongWord 

Result (least significant) 


Takes the two 32 bit inputs, multiplies them together and produces a 64 
bit result. If the inputs were unsigned, the 64 bit result is unsigned. If the 
inputs were signed, the low two words of the 64 bit result is the signed 
result. 


LongDivide 

Function number = 

$0D 

Input 

LongWord 

Space for Remainder 

Input 

LongWord 

Space for Quotient 

Input 

LongWord 

Numerator 

Input 

LongWord 

Denominator 

Output 

LongWord 

Remainder 

Output 

LongWord 

Quotient 


Takes the two 32 bit unsigned inputs and divides them producing two 32 
bit unsigned results. 
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PixRatio 


Function number ■ $0E 


Input 

Input 

Input 

Output 


LongWord 

Word 

Word 

LongWord 


Space for Result 
Numerator 
Denominator 
Result 


Takes the two 16 bit signed inputs and produces a 32 bit fixed point 
result that is the ratio of the numerator and denominator. 


FixMul 


Function number« $0F 


Input 

Input 

Input 

Output 


LongWord 

LongWord 

LongWord 

LongWord 


Space for Result 

Ml 

M2 

Result 


Takes the two 32 bit fixed point inputs and produces a rounded 32 bit 
fixed point result that is the product of the inputs. Overflows return the 
most postive or negative value depending on the exclusive or of the 
inputs signs. 


FracMul 


Function number = $10 


Input 

Input 

Input 

Output 


LongWord 

LongWord 

LongWord 

LongWord 


Space for Result 

Ml 

M2 

Result 


Multiplies two Frac inputs and returns a rounded frac result. Overflows 
return the most postive or negative value depending on the exclusive or 
of the inputs signs. 


FixDiv 


Function number = $11 


Input 

Input 

Input 

Output 


LongWord 

LongWord 

LongWord 

LongWord 


Space for Result 
Quotient 
Divisor 
Result 


Divides two Fixed inputs and returns a rounded fixed result (no 
remainder). Overflows return the most postive or negative value 
depending on the exclusive or of the inputs signs. 
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FracDiv 


Function number = $12 


Input 

Input 

Input 

Output 


LongWord 

LongWord 

LongWord 

LongWord 


Space for Result 
Quotient 
Divisor 
Result 


Divides two Frac inputs and returns a rounded Frac result (no 
remainder). Overflows return the most postive or negative value 
depending on the exclusive or of the inputs signs. 


Fix Round Function number * $13 


Input Word Space for Result 

Input LongWord Original Fixed value 

Output word integer Result 

Takes a Fixed input and returns a rounded integer result. 


FracSqrt Function number» $14 

Input LongWord Space for Result 

Input LongWord Original Frac value 

Output LongWord Result 

Takes a Frac input and returns a rounded Frac square root. (Note: the 
input is taken as unsigned with the leading bit significant, i.e., the input 
range is from 0 to almost 4). 


FracCos Function number = $15 

Input LongWord Space for Result 

Input LongWord Angie (fixed) 

Output - LongWord Result (fixed) 

Takes a Fixed input (radians) and returns its cosine. 


FracSin 


Function number = $16 


Input 

Input 

Output 


LongWord Space for Result 

LongWord Angle (fixed) 

LongWord Result (fixed) 
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Takes a Fixed input (radians) and returns its sine. 


FixATan2 


Function number * $17 


input LongWord Space for Result 

Input LongWord Input 1 

Input LongWord Input 2 

Output LongWord Result (fixed) 

Takes two inputs and returns a fixed point arc tangent (radians) of their 
coordinate. The inputs can be long integer, fixed or Frac (but must be of 
the same type). 


Hi Word 

Function number = 

$18 

Input 

Word 

Space for Result 

Input 

LongWord 

Input 

Output 

Word 

Result 

Returns 

high word of input. 


LoWord 

Function number» 

$19 

Input 

Word 

Space for Result 

Input 

LongWord 

Input 

Output 

Word 

Result 

Returns 

low word of input. 


Long2Fix 

Function number * 

$1A 

Input 

LongWord 

Space for Result 

Input 

LongWord 

Input 

Output 

LongWord 

Result (fixed) 


Converts long integer to fixed. Overflows return the most postive or 
negative value depending on the input sign. 


Fix2Long 


Function number ■ $1B 


Input LongWord Space for Result 

Input LongWord Input 

Output LongWord Result (Longlnt) 
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Converts fixed to long integer. Conversions are rounded. 




X2Frac 


Function number« $21 


Input LongWord space for frac result 

Input LongWord Pointer to Extended 

Output LongWord frac result 

Converts extended to Frac. Conversions are rounded. Overflows, NaNs, 
and Infinities return the most postive or negative value depending on 
sign of the input. 
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CONVERSION ROUTINES 


These routines convert between a binary value and an ASCII character string 
representing that value. The binary value can be either a 2-byte integer or a 4- 
byte integer. The character string can be in either hexadecimal or decimal 
format. 


lnt2Hex 


Function number = $22 


Input Word 2-byte unsigned integer 

Input LongWord Pointer to output string 

Input Word Length of output string 


Takes a 2-byte unsigned integer and produces an ASCII string 
representing the value in hexadecimal format. The string is right-justified 
and padded at the left with zeros. If the string is too short to represent the 
value, an error is returned. The ASCII characters in the output string 
have the high bit clear. 


Long2Hex Function number« $23 

Input LongWord 4-byte unsigned integer 

Input LongWord Pointer to output string 

Input Word Length of output string 


Takes a 4-byte unsigned integer and produces an ASCII string 
representing the value in hexadecimal format. The string is right-justified 
and padded at the left with zeros. If the string is too short to represent the 
value, an error is returned. The ASCII characters in the output string 
have the high bit clear. 


Hex2lnt 


Function number■ $24 


Input 

Input 

Input 

Output 


Word 

LongWord 

Word 

Word 


Space for result 
Pointer to input string 
Length of input string 
2-byte unsigned integer 


Takes an ASCII string representing a hexadecimal value and produces a 
2-byte unsigned integer. The string should be right-justified and may be 
padded at the left with blanks or zeros. The ASCII characters in the string 
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may have the high bit either set or clear. Illegal characters in the string 
will cause an error to be returned. If the hexadecimal value is greater 
than $FFFF, an overflow error will be returned. 


Hex2Long 


Function number • $25 


Input 

Input 

Input 

Output 


LongWord 

LongWord 

Word 

LongWord 


Space for Result 
Pointer to input string 
Length of input string 
4-byte unsigned integer 


Takes an ASCII string representing a hexadecimal value and produces a 
4-byte unsigned integer. The string should be right-justified and may be 
padded at the left with blanks or zeros. The ASCII characters in the string 
may have the high bit either set or clear. Illegal characters in the string 
will cause an error to be returned. If the hexadecimal value is greater 
than $FFFFFFFF, an overflow error will be returned. 


lnt2Dec 


Function number■ $26 


Input Word 2-byte integer 

Input LongWord Pointer to output string 

input Word Length of output string 

Input Word Signed flag 


Takes a 2-byte integer and produces an ASCII string representing the 
value in decimal format. The string is right-justified and padded at the left 
with blanks. The ASCII characters in the string have the high bit clear. If 
the Signed flag ■ 0, the integer will be considered to be unsigned. If the 
Signed flag o 0, the integer will be considered to be signed. If a signed 
integer is negative, the string will contain an ASCII minus sign to the left 
of the most-significant digit. If the string is too short to represent the 
value, an error is returned. 


Dec 

Function number* 

$27 

Input 

LongWord 

4-byte integer 




Input 

Word 

Length of output string 

Input 

Word 

Signed flag 


Takes a 4-byte integer and produces an ASCII string representing the 
value in decimal format. The string is right-justified and padded at the left 
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with blanks. The ASCII characters in the string have the high bit clear. If 
the Signed flag - 0, the integer will be considered to be unsigned. If the 
Signed flag <> 0, the integer will be considered to be signed. If a signed 
integer is negative, the string will contain an ASCII minus sign to the left 
of the most-significant digit. If the string is too short to represent the 
value, an error is returned. 


Dec2lnt Function number« $28 


Input 

Word 

Space for result 

Input 

LongWord 

Pointer to input string 

Input 

Word 

Length of input string 

Input 

Word 

Signed flag 

Output 

Word 

2-byte integer 


Takes an ASCII string representing a decimal value and produces a 2- 
byte Integer. The string should be right-justified and may be padded at 
the left with blanks or zeros. The ASCII characters in the string may have 
the high bit either set or clear. If the Signed flag = 0, the value will be 
considered to be unsigned, if the Signed flag o 0, the value will be 
considered to be signed. If the value is signed, the string may contain an 
ASCII plus or minus sign directly in front of the most-significant digit. 
Illegal characters in the string will cause an error to be returned. If a 
signed value is greater than 32,767 or less than -32,768 an overflow 
error will be returned. If an unsigned value is greater than 65,535 an 
overflow error will be returned. 


Dec2Long 


Function number = $29 


Input 

Input 

Input 

Input 

Output 


LongWord 

LongWord 

Word 

Word 

LongWord 


Space for Result 
Pointer to input string 
Length of input string 
Signed flag 
4-byte integer 


Takes an ASCII string representing a decimal value and produces a 4- 
byte integer. The string should be right-justified and may be padded at 
the left with blanks or zeros. The ASCII characters in the string may have 
the high bit either set or clear. If the Signed flag = 0, the value will be 
considered to be unsigned. If the Signed flag o 0, the value will be 
considered to be signed. If the value is signed, the string may contain an 
ASCII plus or minus sign directly in front of the most-significant digit. 
Illegal characters in the string will cause an error to be returned. If a 
signed value is greater than 2,147,483,647 or less than -2,147,483,648 
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an overflow error will be returned. If an unsigned value is greater than 
4,294,967,295 an overflow error will be returned. 


Hexlt 


Function number«* $2A 


Input 

Input 

Output 


LongWord 

Word 

LongWord 


Space for result 
2-byte unsigned integer 
4-byte hexadecimal string 


Takes a 2-byte unsigned integer and returns a 4-byte ASCII string 
representing the value in hexadecimal format. 
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EBBQBSQPES 


$0B01 

Bad input parameter 

$0502 

Illegal character in string 

$0503 

Integer or Long Integer overflow 

$0604 

String overflow 
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